MarkLogic 9 Product Documentation
GET /v1/config/properties/{property-name}

Summary

Retrieve the value of the MarkLogic REST API instance configuration property named by {property-name}.

URL Parameters
format?	Specifies the content type of the response, as an alternative to using the Accept header. Accepted values: `json` and `xml` (default). This value takes precedence over the Accept headers.

Request Headers
Accept	The expected MIME type of the information in the response. Accepted types: `application/json` or `application/xml`. Ignored if the request includes a `format` parameter value.

Response Headers
Content-Type	The MIME type of the content returned in the response body, one of `application/xml` or `application/json`, depending on the type requested by the `format` value or Accept header.

Response

Upon success, MarkLogic Server returns a 200 status, with the requested data in the response body. If the requested property does not exist, MarkLogic Server returns status 404 (Not Found).

Required Privileges

This operation requires the rest-admin role, or the following privileges:

http://marklogic.com/xdmp/privileges/rest-admin

http://marklogic.com/xdmp/privileges/rest-writer

http://marklogic.com/xdmp/privileges/rest-reader

Usage Notes

The expected response content type can be specified using either the format parameter or Accept header. One or the other must be supplied. If both are supplied and are different, the format parameter takes precedence.

The following properties are available for configuration:

Propety Name	Description
content-versions	Deprecated. Use `update-policy` instead.
debug	Controls debugging output. Allowed values: true, false. Default: false.
document-transform-all	Whether or not to apply a default read transform to every document read, regardless of user. When false, a default transform does not modify documents read by a user with `rest-writer` or `rest-admin` role (or equivalent privileges. Use `document-transform-out` to specify a default read transformation. Default: true.
document-transform-out	The name of a default content transformation to apply when retrieving documents from the database using /documents. Default: no transformation.
update-policy	Determines the behavior of conditional GET, PUT, POST, and DELETE on `/documents` and metadata handling on updates. Allowed Values: `merge-metadata` (default), `version-required`, `version-optional`, `overwrite-metadata`. For details, see Understanding Optimistic Locking in the REST Application Developer's Guide and Client-Side Cache Management Using Content Versioning in the REST Application Developer's Guide.
validate-options	Whether or not to validate query options when they are created or updated. Allowed values: true, false. Default: true.
validate-queries	Whether or not to validate a query before searching. Allowed values: true, false. Default: false.

For more details, see Configuring Instance Properties in the REST Application Developer's Guide.

Example

$ curl --anyauth --user user:password -X GET -i \
    http://localhost:8000/v1/config/properties/debug

==> MarkLogic Server returns the setting of the configuration property 
    "debug", as XML. For example:

HTTP/1.1 200 OK
Server: MarkLogic
Content-Type: text/xml; charset=UTF-8
Content-Length: 74
Connection: close

<rapi:debug xmlns:rapi="http://marklogic.com/rest-api">
  false
</rapi:debug>

Example

$ curl --anyauth --user user:password -X GET -i -H "Accept: application/json" \
    'http://localhost:8000/v1/config/properties/debug'

==> MarkLogic Server returns the setting of the configuration property 
    "debug", as JSON. For example:

HTTP/1.1 200 OK
Server: MarkLogic
Content-Type: text/xml; charset=UTF-8
Content-Length: 15
Connection: close

{"debug":false}

MarkLogic 9 Product DocumentationGET /v1/config/properties/{property-name}

Summary

Response

Required Privileges

Usage Notes

Example

Example

MarkLogic 9 Product Documentation
GET /v1/config/properties/{property-name}